home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / as.man < prev    next >
Encoding:
Text File  |  1989-01-28  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. AS                        User Commands                        AS
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      as - Sun-1, Sun-2 and Sun-3 assembler
  10.  
  11. SSYYNNOOPPSSIISS
  12.      aass [ --dd22 ] [ --ee ] [ --hh ] [ --jj ] [ --JJ ] [ --LL ]
  13.           [ --mmcc6688001100 ] [ --mmcc6688002200 ] [ --oo _o_b_j_f_i_l_e ]
  14.           [ --OO ] [ --RR ] _f_i_l_e_n_a_m_e
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      _a_s translates assembly code in the named _f_i_l_e_n_a_m_e into exe-
  18.      cutable object code in the specified _o_b_j_f_i_l_e.
  19.  
  20.      All undefined symbols in the assembly are treated as global.
  21.  
  22.      The output of the assembly is left in the file _o_b_j_f_i_l_e.
  23.  
  24. OOPPTTIIOONNSS
  25.      --dd22  Specifies that instruction offsets involving forward or
  26.           external references and having sizes unspecified in the
  27.           assembly language are two bytes long.  The default is
  28.           four bytes. See also the --jj option.
  29.  
  30.      --ee   Allows control sections to begin on any two-byte boun-
  31.           dary, rather than only four-byte boundaries.
  32.  
  33.      --hh   Suppress span-dependent instruction calculations and
  34.           force all branches to be of medium length, but all
  35.           calls to take the most general form. This is used when
  36.           assembly must be minimized, while program size and
  37.           run-time are unimportant.  This option results in a
  38.           smaller and faster program than that produced by the --JJ
  39.           option, but some very large programs may not be able to
  40.           use it because of the limits of the medium-length
  41.           branches.
  42.  
  43.      --jj   Use short (pc-relative) branches to resolve jump's and
  44.           jsr's to externals.  This is for compact programs which
  45.           cannot use the --dd22 flag because of large program relo-
  46.           cation.
  47.  
  48.      --JJ   Suppress span-dependent instruction calculations and
  49.           force all branches and calls to take the most general
  50.           form. This is used when assembly time must be minim-
  51.           ized, but program size and run time are not important.
  52.  
  53.      --LL   Save defined labels beginning with an `L', which are
  54.           normally discarded to save space in the resultant sym-
  55.           bol table.  The compilers generate such temporary
  56.           labels.
  57.  
  58.      --mmcc6688001100
  59.           Accept only MC68010 instructions and addressing modes,
  60.  
  61.  
  62.  
  63. Sprite v1.0               20 March 1986                         1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AS                        User Commands                        AS
  71.  
  72.  
  73.  
  74.           and put the MC68010 machine-type tag in the object
  75.           file.  This is the default on Sun-2's.
  76.  
  77.      --mmcc6688002200
  78.           Accept the full MC68020, MC68881 and the Sun FPA
  79.           instruction sets and addressing modes, and put the
  80.           MC68020 machine-type tag in the object file.  This is
  81.           the default on Sun 3's.
  82.  
  83.      --oo   The next argument is taken as the name of the object
  84.           file to be produced.  If the --oo flag isn't used, the
  85.           _o_b_j_f_i_l_e is named _a.._o_u_t.
  86.  
  87.      --OO   Perform span-dependent instruction resolution over
  88.           entire files rather than just over individual pro-
  89.           cedures.
  90.  
  91.      --RR   Make initialized data segments read-only by concatenat-
  92.           ing them to the text segments.  This eliminates the
  93.           need to run editor scripts on assembly code to make
  94.           initialized data read-only and shared.
  95.  
  96. FFIILLEESS
  97.      /_t_m_p/_a_s*       default temporary file
  98.  
  99. SSEEEE AALLSSOO
  100.      ld(1), nm(1), adb(1), dbx(1), a.out(5)
  101.  
  102.      _A_s_s_e_m_b_l_y _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l
  103.  
  104. BBUUGGSS
  105.      The Pascal compiler, _p_c, qualifies a nested procedure name
  106.      by chaining the names of the enclosing procedures.  This
  107.      sometimes results in names long enough to abort the assem-
  108.      bler, which currently limits identifiers to 512 characters.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0               20 March 1986                         2
  130.  
  131.  
  132.  
  133.